[GI] Mark callbacks' context parameter with (closure) annotation.
authorPavel Holejsovsky <pholejs@src.gnome.org>
Tue, 18 Jan 2011 05:28:24 +0000 (06:28 +0100)
committerPavel Holejsovsky <pholejs@src.gnome.org>
Tue, 18 Jan 2011 16:20:32 +0000 (17:20 +0100)
docs/reference/gtk/tmpl/gtkprintoperation.sgml
gdk/gdkevents.h
gtk/gtkaccelgroup.h
gtk/gtkassistant.h
gtk/gtkcellarea.h
gtk/gtkfilefilter.h
gtk/gtkprinter.h
gtk/gtkprintoperation.h
gtk/gtktreemodelfilter.h
gtk/gtktreeselection.h
gtk/gtktreeview.h

index 00cc328b35d17a002ac638c0f37e253d8eb7fea9..0b0446026ebc2c2762e2642b725c4ccc2cce5a5d 100644 (file)
@@ -630,14 +630,11 @@ The #GQuark used for #GtkPrintError errors.
 
 <!-- ##### USER_FUNCTION GtkPageSetupDoneFunc ##### -->
 <para>
-The type of function that is passed to gtk_print_run_page_setup_dialog_async().
-This function will be called when the page setup dialog is dismissed, and
-also serves as destroy notify for @data.
+
 </para>
 
-@page_setup: the #GtkPageSetup that has been
-@data: user data that has been passed to 
-       gtk_print_run_page_setup_dialog_async().
+@page_setup:
+@data:
 
 
 <!-- ##### FUNCTION gtk_print_run_page_setup_dialog_async ##### -->
index b7e5ed37a24a7e06e180c9367f273f315995fead..258be496a115349d5af824e3569583d2e0497fbb 100644 (file)
@@ -100,7 +100,7 @@ typedef union  _GdkEvent        GdkEvent;
 /**
  * GdkEventFunc:
  * @event: the #GdkEvent to process.
- * @data: user data set when the event handler was installed with
+ * @data: (closure): user data set when the event handler was installed with
  *   gdk_event_handler_set().
  *
  * Specifies the type of function passed to gdk_event_handler_set() to
index 5efe4fa87e2b07ce2c561968c89953e2245b5634..3195a91b3ea542ba418435f90378fef57f0daa06 100644 (file)
@@ -71,7 +71,7 @@ typedef gboolean (*GtkAccelGroupActivate) (GtkAccelGroup  *accel_group,
  * GtkAccelGroupFindFunc:
  * @key: 
  * @closure: 
- * @data: 
+ * @data: (closure):
  * 
  * Since: 2.2
  */
index ea3ae8168da5f28c02481a5566bada1a8f463f42..62f9eadbc2ccbc48e6d6f43020b341449c977312 100644 (file)
@@ -111,7 +111,7 @@ struct _GtkAssistantClass
 /**
  * GtkAssistantPageFunc:
  * @current_page: The page number used to calculate the next page.
- * @data: user data.
+ * @data: (closure): user data.
  *
  * A function used by gtk_assistant_set_forward_page_func() to know which
  * is the next page given a current one. It's called both for computing the
index 78d5e954505d348487e070c3de9a5eb78bbc1fb0..2b0f707b9b1f81a35bec996f89a34b8fa9fadb2e 100644 (file)
@@ -62,7 +62,7 @@ typedef struct _GtkCellAreaContext       GtkCellAreaContext;
 /**
  * GtkCellCallback:
  * @renderer: the cell renderer to operate on
- * @data: user-supplied data
+ * @data: (closure): user-supplied data
  *
  * The type of the callback functions used for iterating over
  * the cell renderers of a #GtkCellArea, see gtk_cell_area_foreach().
@@ -79,7 +79,7 @@ typedef gboolean    (*GtkCellCallback) (GtkCellRenderer  *renderer,
  *     provided to gtk_cell_area_foreach_alloc().
  * @cell_background: the background area for @renderer inside the
  *     background area provided to gtk_cell_area_foreach_alloc().
- * @data: user-supplied data
+ * @data: (closure): user-supplied data
  *
  * The type of the callback functions used for iterating over the
  * cell renderers and their allocated areas inside a #GtkCellArea,
index c566ef17a8ed66c7751cfbe71b1f8636bb410264..02e277557deeb59621a6aa6f5c8947fc914a6a09 100644 (file)
@@ -58,7 +58,7 @@ typedef enum {
  * GtkFileFilterFunc:
  * @filter_info: a #GtkFileFilterInfo that is filled according
  *   to the @needed flags passed to gtk_file_filter_add_custom()
- * @data: user data passed to gtk_file_filter_add_custom()
+ * @data: (closure): user data passed to gtk_file_filter_add_custom()
  *
  * The type of function that is used with custom filters, see
  * gtk_file_filter_add_custom().
index ba7506ad32276760bb6617247915032ba3af8490..f2c18c10c21c76511a12e76be79d6202b4b341cd 100644 (file)
@@ -124,7 +124,7 @@ gboolean                 gtk_printer_get_hard_margins      (GtkPrinter       *pr
 /**
  * GtkPrinterFunc:
  * @printer: a #GtkPrinter
- * @data: user data passed to gtk_enumerate_printers()
+ * @data: (closure): user data passed to gtk_enumerate_printers()
  *
  * The type of function passed to gtk_enumerate_printers().
  * Note that you need to ref @printer, if you want to keep
index bba15cc632887ee7dda49357f935d5f75747e22e..5c2b2167e82f2006038bd2948ae20e6e98fc007b 100644 (file)
@@ -196,6 +196,17 @@ GtkPageSetup           *gtk_print_run_page_setup_dialog            (GtkWindow
                                                                    GtkPageSetup       *page_setup,
                                                                    GtkPrintSettings   *settings);
 
+/**
+ * GtkPageSetupDoneFunc:
+ * @page_setup: the #GtkPageSetup that has been
+ * @data: (closure): user data that has been passed to 
+ *        gtk_print_run_page_setup_dialog_async().
+ *
+ * The type of function that is passed to
+ * gtk_print_run_page_setup_dialog_async().  This function will be
+ * called when the page setup dialog is dismissed, and also serves as
+ * destroy notify for @data.
+ */
 typedef void  (* GtkPageSetupDoneFunc) (GtkPageSetup *page_setup,
                                        gpointer      data);
 
index b8c3376886c88cb3a197738b7215164760f54720..b887a0ac69905dc1b0ddf9329680bfaf338ef22b 100644 (file)
@@ -41,7 +41,7 @@ G_BEGIN_DECLS
  * @model: the child model of the #GtkTreeModelFilter
  * @iter: a #GtkTreeIter pointing to the row in @model whose visibility
  *   is determined
- * @data: user data given to gtk_tree_model_filter_set_visible_func()
+ * @data: (closure): user data given to gtk_tree_model_filter_set_visible_func()
  *
  * A function which decides whether the row indicated by @iter is visible.
  *
@@ -58,7 +58,7 @@ typedef gboolean (* GtkTreeModelFilterVisibleFunc) (GtkTreeModel *model,
  * @value: A #GValue which is already initialized for with the correct type for
  *  the column @column.
  * @column: the column whose display value is determined
- * @data: user data given to gtk_tree_model_filter_set_modify_func()
+ * @data: (closure): user data given to gtk_tree_model_filter_set_modify_func()
  *
  * A function which calculates display values from raw values in the model.
  * It must fill @value with the display value for the column @column in the
index 36cfafa7fd51a7c161e3192935f188c2599904c5..9dfdb9f5d2a45f2aba7c183e7d92cee0b4189aa9 100644 (file)
@@ -44,7 +44,7 @@ typedef struct _GtkTreeSelectionPrivate      GtkTreeSelectionPrivate;
  * @model: A #GtkTreeModel being viewed
  * @path: The #GtkTreePath of the row in question
  * @path_currently_selected: %TRUE, if the path is currently selected
- * @data: user data
+ * @data: (closure): user data
  *
  * A function used by gtk_tree_selection_set_select_function() to filter
  * whether or not a row may be selected.  It is called whenever a row's
@@ -64,7 +64,7 @@ typedef gboolean (* GtkTreeSelectionFunc)    (GtkTreeSelection  *selection,
  * @model: The #GtkTreeModel being viewed
  * @path: The #GtkTreePath of a selected row
  * @iter: A #GtkTreeIter pointing to a selected row
- * @data: user data
+ * @data: (closure): user data
  *
  * A function used by gtk_tree_selection_selected_foreach() to map all
  * selected rows.  It will be called on every selected row in the view.
index 9e2227b026473b26934d57ba9caee9991c9b2344..80aa134af61df143565e60949287b7304d516ae4 100644 (file)
@@ -129,7 +129,7 @@ struct _GtkTreeViewClass
  * @column: The #GtkTreeViewColumn being dragged
  * @prev_column: A #GtkTreeViewColumn on one side of @column
  * @next_column: A #GtkTreeViewColumn on the other side of @column
- * @data: user data
+ * @data: (closure): user data
  *
  * Function type for determining whether @column can be dropped in a
  * particular spot (as determined by @prev_column and @next_column).  In
@@ -167,7 +167,7 @@ typedef void     (* GtkTreeViewMappingFunc)    (GtkTreeView             *tree_vi
  * @key: the key string to compare with
  * @iter: a #GtkTreeIter pointing the row of @model that should be compared
  *  with @key.
- * @search_data: user data from gtk_tree_view_set_search_equal_func()
+ * @search_data: (closure): user data from gtk_tree_view_set_search_equal_func()
  *
  * A function used for checking whether a row in @model matches
  * a search key string entered by the user. Note the return value
@@ -186,7 +186,7 @@ typedef gboolean (*GtkTreeViewSearchEqualFunc) (GtkTreeModel            *model,
  * GtkTreeViewRowSeparatorFunc:
  * @model: the #GtkTreeModel
  * @iter: a #GtkTreeIter pointing at a row in @model
- * @data: user data
+ * @data: (closure): user data
  *
  * Function type for determining whether the row pointed to by @iter should
  * be rendered as a separator. A common way to implement this is to have a